@KirtiRamchandani As discussed, it's best not to fix issues that still have the "needs-triage" label - they might not be correct, and even if they are true, the proposed solution might not be optimal.

I've suggested a solution in in #44273 (comment)
I still think your note is also useful in addition, but it probably should mention both the deprecated method and the new alternative, so people can make an informed decision.

Thanks, updated in fe3ec4495e to follow the suggested direction:

• the examples now use transport.datagrams.createWritable() when supported.
• they fall back to transport.datagrams.writable with an inline deprecated/non-standard comment.
• the note now mentions both the newer method and the deprecated property so readers know to check compatibility before choosing a write API.

Local checks:

• corepack npm exec --yes --package prettier@3.8.3 -- prettier --check files/en-us/web/api/webtransport/datagrams/index.md files/en-us/web/api/webtransportdatagramduplexstream/index.md
• corepack npm exec --yes --package markdownlint-cli2@0.22.1 --package markdownlint-rule-search-replace@1.2.0 -- markdownlint-cli2 files/en-us/web/api/webtransport/datagrams/index.md files/en-us/web/api/webtransportdatagramduplexstream/index.md
• git diff --check

Preview URLs (2 pages)

• /en-US/docs/Web/API/WebTransport/datagrams
• /en-US/docs/Web/API/WebTransportDatagramDuplexStream

Flaws (4)

Found an unexpected or unresolvable flaw? Please report it here.

URL: /en-US/docs/Web/API/WebTransport/datagrams
Title: WebTransport: datagrams property
Flaw count: 2

• macros:
  • Macro domxref produces link /en-US/docs/Web/API/WebTransportDatagramDuplexStream/createWritable which doesn't resolve
  • Macro domxref produces link /en-US/docs/Web/API/WebTransportDatagramsWritable which doesn't resolve

URL: /en-US/docs/Web/API/WebTransportDatagramDuplexStream
Title: WebTransportDatagramDuplexStream
Flaw count: 2

• macros:
  • Macro domxref produces link /en-US/docs/Web/API/WebTransportDatagramDuplexStream/createWritable which doesn't resolve
  • Macro domxref produces link /en-US/docs/Web/API/WebTransportDatagramsWritable which doesn't resolve

(comment last updated: 2026-06-09 06:36:50)

I've created #44383 that this can go in after. Note, I also modified the text slightly. This was merged into your commit accidentally, so it ias attributed to you. I decided not to use a note to highlight the differences between the method and property.

Anyway, I'll look at this again after #44383 goes in.